home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir30 / drftls.zip / !MANUAL.TXT < prev    next >
Text File  |  1993-11-21  |  42KB  |  927 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                  DrafTools(tm) for AutoCAD(tm)* --
  16.  
  17.  
  18.                            Installation & Operation Manual
  19.  
  20.                            For Custom Title Block Management Routines
  21.  
  22.                                                Version 1.00
  23.  
  24.  
  25.  
  26.                                 Copyright 1993  Owen Wengerd
  27.  
  28.                                 Manu-Soft Computer Services
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                                 by Owen Wengerd
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                 Printed 10/03/93
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.           * AutoCAD, ACAD, AutoLISP, and ADS are trademarks of Autodesk, Inc.
  55.  
  56.  
  57. ==============   DrafTools(tm) Installation & Operation Manual             2
  58.  
  59.  
  60.                DISCLAIMER - AGREEMENT
  61.  
  62.          Users of DrafTools(tm) must accept this disclaimer of warranty:
  63.        "DrafTools(tm) is supplied as is.  The author disclaims all warranties,
  64.        expressed or implied, including, without limitation, the warranties of
  65.        merchantability and of fitness for any purpose.  The author assumes no
  66.        liability for damages, direct or consequential, which may result from
  67.        the use of DrafTools."
  68.  
  69.          DrafTools(tm) is a "shareware program" and is provided at no charge to
  70.        the user for evaluation.  Feel free to share it with your friends, but
  71.        please do not give it away altered or as part of another system.  The
  72.        essence of "user-supported" software is to provide personal computer
  73.        users with quality software without high prices, and yet to provide
  74.        incentive for programmers to continue to develop new products.  If you
  75.        find this program useful and find that you are using DrafTools(tm) and
  76.        continue to use DrafTools(tm) after a reasonable trial period, you must
  77.        make a registration payment of $25.00 (US) to Manu-Soft Computer
  78.        Services.  The $25.00 registration fee will license one copy for use
  79.        on any one computer at any one time.  You must treat this software
  80.        just like a book.  An example is that this software may be used by any
  81.        number of people and may be freely moved from one computer location to
  82.        another, so long as there is no possibility of it being used at one
  83.        location while it's being used at another.  Just as a book cannot be
  84.        read by two different persons at the same time.
  85.  
  86.          Commercial users of DrafTools(tm) must register and pay for their copies
  87.        of DrafTools(tm) within 30 days of first use or their license is
  88.        withdrawn.  Site-License arrangements may be made by contacting
  89.        Manu-Soft Computer Services.
  90.          Anyone distributing DrafTools(tm) for any kind of remuneration must
  91.        first contact Manu-Soft Computer Services at the address below for
  92.        authorization.  This authorization will be automatically granted to
  93.        distributors recognized by the Association of Shareware Professionals
  94.        (ASP) as adhering to its guidelines for shareware distributors, and
  95.        such distributors may begin offering DrafTools(tm) immediately (However
  96.        Manu-Soft Computer Services must still be advised so that the
  97.        distributor can be kept up-to-date with the latest version of
  98.        DrafTools(tm)).
  99.          You are encouraged to pass a copy of DrafTools(tm) along to your friends
  100.        for evaluation.  Please encourage them to register their copy if they
  101.        find that they can use it.  All registered users will receive the
  102.        following:
  103.                  The latest version of DrafTools(tm)
  104.                  Unprotected source code
  105.                  Free minor updates as they occur
  106.                  Free technical support
  107.                  Special reduced rates on major upgrades
  108.  
  109.  
  110.        To register, print the order form (!ORDER.FRM) and send it with check
  111.        or money order for $25.00 (US) per copy to:
  112.  
  113.             DrafTools
  114.             Manu-Soft Computer Services
  115.             P.O. Box 84
  116.             Fredericksburg, OH  44627
  117.  
  118.  
  119. ==============   DrafTools(tm) Installation & Operation Manual             3
  120.  
  121.  
  122.  
  123.                                   TABLE OF CONTENTS
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                  I. THE SHAREWARE CONCEPT                          4
  132.  
  133.                  II. INTRODUCTION                                  5
  134.  
  135.                  III. SYSTEM REQUIREMENTS                          5
  136.  
  137.                  IV. INSTALLATION INSTRUCTIONS                     6
  138.  
  139.                       A. Copying Files To Your Hard Disk           6
  140.  
  141.                       B. Editing ACAD.MNU                          7
  142.  
  143.                       C. Editing ACAD.LSP                          8
  144.  
  145.                       D. Checking The Installation                 9
  146.  
  147.                  V. GETTING STARTED                                10
  148.  
  149.                       A. Using the Sample Title Blocks             10
  150.  
  151.                       B. Defining Your Own Title Block             12
  152.  
  153.                       C. Customizing TBLOCK.LSP                    15
  154.  
  155.                  VI. REPORTING PROBLEMS & GETTING SUPPORT          16
  156.  
  157.                  VII. REGISTRATION                                 16
  158.  
  159.                  VIII. APPENDIX A--Files Included with DrafTools   17
  160.  
  161.                       A. Installation and Documentation            17
  162.  
  163.                       B. DrafTools Program Files                   17
  164.  
  165.                       C. Sample Programs                           18
  166.  
  167.                  IX. APPENDIX B--Global Variables                  19
  168.  
  169.                  X. APPENDIX C--Supplied User Functions            20
  170.  
  171.  
  172. ==============   DrafTools(tm) Installation & Operation Manual             4
  173.  
  174.  
  175.                       I. THE SHAREWARE CONCEPT
  176.  
  177.  
  178.  
  179.        Shareware distribution gives users a chance to try software
  180.        before buying it.  If you try a Shareware program and continue
  181.        using it, you are expected to register. Individual programs
  182.        differ on details -- some request registration while others
  183.        require it, some specify a maximum trial period.  With
  184.        registration, you get anything from the simple right to continue
  185.        using the software to an updated program with printed manual.
  186.  
  187.        Copyright laws apply to both Shareware and commercial software,
  188.        and the copyright holder retains all rights, with a few specific
  189.        exceptions as stated below. Shareware authors are accomplished
  190.        programmers, just like commercial authors, and the programs are
  191.        of comparable quality.  (In both cases, there are good programs
  192.        and bad ones!) The main difference is in the method of
  193.        distribution.  The author specifically grants the right to copy
  194.        and distribute the software, either to all and sundry or to a
  195.        specific group.  For example, some authors require written
  196.        permission before a commercial disk vendor may copy their
  197.        Shareware.
  198.  
  199.        Shareware is a distribution method, not a type of software.  You
  200.        should find software that suits your needs and pocketbook,
  201.        whether it's commercial or Shareware.  The Shareware system makes
  202.        fitting your needs easier, because you can try before you buy.
  203.        And because the overhead is low, prices are low also. Shareware
  204.        has the ultimate money-back guarantee -- if you don't use the
  205.        product, you don't pay for it.
  206.  
  207.  
  208. ==============   DrafTools(tm) Installation & Operation Manual             5
  209.  
  210.  
  211.                       II. INTRODUCTION
  212.  
  213.  
  214.  
  215.             DrafTools(tm) is a comprehensive set of LISP routines designed to
  216.        automate the tedious process of creating and using title blocks,
  217.        adding and updating revision blocks, and inserting tables of hole
  218.        sizes, bills-of-material, etc.  This manual covers only the Custom
  219.        Title Block Management portion of DrafTools(tm).  For information on 
  220.        other modules please contact the author (see Section VI for address).
  221.  
  222.             NOTE:  This manual is intended for use by someone already
  223.        familiar with AutoCAD Release 12, AutoLISP variables, and the MSDOS
  224.        file structure.  The installation process also requires the ability to
  225.        edit the ACAD.MNU file with a text editor.  The recommended method is
  226.        by using Microsoft's EDIT.COM included with MSDOS 5.0 & 6.0, since
  227.        many other editors cannot load a file as large as ACAD.MNU.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                       III. SYSTEM REQUIREMENTS
  238.  
  239.  
  240.  
  241.             IBM-Compatible PC with MSDOS operating system
  242.             AutoCAD Release 12/Dos, installed & running
  243.             Text editor (preferably EDIT.COM by Microsoft)
  244.             Approx. 380K Hard Disk Space
  245.  
  246.  
  247. ==============   DrafTools(tm) Installation & Operation Manual             6
  248.  
  249.  
  250.                       IV. INSTALLATION INSTRUCTIONS
  251.  
  252.  
  253.  
  254.             A. Copying Files To Your Hard Disk
  255.  
  256.  
  257.             Before beginning the installation process, you need to decide
  258.        where on your hard disk you want to put the DrafTools Applications.
  259.        In order to keep DrafTools separate from other AutoCAD files, it is
  260.        recommended that you create a subdirectory under your AutoCAD
  261.        directory and name it DRAFTOOL.  If your AutoCAD directory is C:\ACAD,
  262.        you would describe this new subdirectory by the pathname
  263.        C:\ACAD\DRAFTOOL.  Here is what your directory structure might look
  264.        like after creating the DRAFTOOL subdirectory:
  265.  
  266.             C:\
  267.              |--ACAD
  268.              |    |--ADS
  269.              |    |    \--DOCS
  270.              |    |--ASE
  271.              |    |--DRAFTOOL   <----DrafTools Directory
  272.              |    |--DRV
  273.              |    |--FONTS
  274.              |    |--IGESFONT
  275.              |    |--R11SUPP
  276.              |    |--SAMPLE
  277.              |    |--SOURCE
  278.              |    |--SUPPORT
  279.              |    \--TUTORIAL
  280.              |         \--DBF
  281.              |--DOS
  282.              \--GAMES
  283.  
  284.  
  285.             After creating a DrafTools subdirectory, simply copy every file
  286.        from the installation diskette into the newly created subdirectory on
  287.        your hard disk.  (See Appendix A for a list of files on the
  288.        installation diskette.)  If you are a first time user, you should also
  289.        copy the sample files (see Appendix A, Section C for a list of sample
  290.        files) to the same newly created subdirectory on your hard disk.
  291.  
  292.  
  293. ==============   DrafTools(tm) Installation & Operation Manual             7
  294.  
  295.  
  296.             B. Editing ACAD.MNU
  297.  
  298.  
  299.             The next step involves adding new menus to your AutoCAD menu
  300.        file.  This step may not be necessary if you already have a previous
  301.        version of DrafTools installed.  Check for additional instructions in
  302.        the README.DOC file on the installation diskette root directory.
  303.             The AutoCAD menu file is ACAD.MNU (unless you have customized
  304.        your menu and given it a different name) and it is located by default
  305.        in the SUPPORT subdirectory.  The use of a text editor which can edit
  306.        very large files (many editors and word processors cannot load large
  307.        files like ACAD.MNU) will be required.  The editor included with MSDOS
  308.        5.0 & 6.0 (EDIT.COM) works very well.
  309.  
  310.             The file ACADPMNU.TXT is an ASCII file which defines a pop-up
  311.        AutoCAD menu allowing the user to execute DrafTools commands.
  312.        Following is a listing of that file:
  313.  
  314.           ***POP10
  315.           [DrafTools]
  316.           [Insert Title Block]^C^CINSTITLE
  317.           [     & Border]^C^CINSTITLE
  318.           [Edit Title Block]^C^CEDTITLE
  319.           [     Attributes]^C^CEDTITLE
  320.           [Define New Title]^C^CMAKEBDR
  321.           [     Block Border]^C^CMAKEBDR
  322.  
  323.  
  324.             To add the DrafTools pop-up menu to your menu file, ACADPMNU.TXT
  325.        must be inserted into your ACAD.MNU file after the last pop-up menu in
  326.        the file.  Consult your AutoCAD manual for information on the
  327.        structure of the ACAD.MNU file.  After inserting the new pop-up menu,
  328.        change the line "***POP10" to "***POPnn", where nn is the next pop-up
  329.        menu number available to you.
  330.  
  331.             NOTE:  To insert ACADPMNU.TXT with EDIT.COM, you first load
  332.        ACADPMNU.TXT into the editor.  Then, highlight everything and pick
  333.        EDIT|COPY to copy the entire file into the EDIT Clipboard.  Next, load
  334.        ACAD.MNU by picking FILE|OPEN and selecting ACAD.MNU.  Once ACAD.MNU
  335.        is in the editor, you can insert the contents of the clipboard at the
  336.        cursor location by picking EDIT|PASTE.
  337.  
  338.  
  339. ==============   DrafTools(tm) Installation & Operation Manual             8
  340.  
  341.  
  342.             C. Editing ACAD.LSP
  343.  
  344.  
  345.             The file DT_INIT.LSP must be loaded by your ACAD.LSP file.  If
  346.        you don't have a file called ACAD.LSP (usually in the SUPPORT
  347.        subdirectory), you must create a new one.  Using an ASCII (plain text)
  348.        editor, add the following line:
  349.  
  350.             (load "C:\\ACAD\\DRAFTOOL\\DT_INIT")
  351.  
  352.        Make sure the path specified points to the directory in which you
  353.        installed DrafTools.  Note the "\\" (Double Backslashes).
  354.  
  355.  
  356.             The file DT_INIT.LSP initializes global variables and user
  357.        settings:  you must edit this file to change customizable settings.
  358.        The section which merits attention (first screen) in DT_INIT.LSP looks
  359.        like this:
  360.  
  361.  
  362.        ; ============================
  363.        ; ==  Set Global Variables  ==
  364.        ; ============================
  365.  
  366.        (setq *DT_PATH "c:\\acad\\draftool\\")
  367.  
  368.        [Set other global variables here]
  369.  
  370.  
  371.  
  372.  
  373.          The (setq *DT_PATH...  line sets the global variable *DT_PATH to the
  374.        DrafTools Subdirectory path.  This variable should always be set, or
  375.        DrafTools may be unable to find required files.
  376.          You may also set the global variable *TBLAYER to the name of the
  377.        layer you want title blocks inserted on.  If *TBLAYER is not defined,
  378.        "TITLE" becomes the default.  You can override the layer setting
  379.        during title block insertion.
  380.          The global variable *TBSCALES is the name of the file containing
  381.        your predefined scales, and defaults to "TBSCALES" if none is
  382.        specified.  TBSCALES.TBD is provided as a sample to get you started.
  383.        By setting different filenames in *TBSCALES, you can maintain multiple
  384.        predefined-scale files (possibly for different disciplines).
  385.  
  386.  
  387. ==============   DrafTools(tm) Installation & Operation Manual             9
  388.  
  389.  
  390.        D. Checking The Installation
  391.  
  392.  
  393.             After ACAD.MNU, ACAD.LSP, and DT_INIT.LSP have been modified and
  394.        saved, start AutoCAD.  Do the following tests to make sure the
  395.        installation is working properly:
  396.  
  397.                  A)  Make sure the pop-up menu you inserted is available.  It
  398.                        should be the right-most pop-up menu along the top of
  399.                        the screen, named 'DrafTools'.  If your display
  400.                        resolution is too low, you may not be able to see all
  401.                        of the pop-up menus.  If this is the case, rearrange
  402.                        their order so that the 'DrafTools' menu is
  403.                        available, or just combine two of your current pop-up
  404.                        menus into one.
  405.  
  406.                  B)  Select "Define New Title Block Border" from the
  407.                        DrafTools Pop-up menu.  If AutoCAD gives you an
  408.                        "error:  Load Failed" message, then your *DT_PATH
  409.                        variable does not specify the correct pathname to
  410.                        your DRAFTOOL subdirectory.  Check DT_INIT.LSP and
  411.                        make sure the path is correctly specified.  (See the
  412.                        installation instructions for further details.)  You
  413.                        should be greeted with a dialog box entitled "Define
  414.                        New Title Block Border".
  415.  
  416.                  C)  Pick the <Reorder and Edit Attributes> button.  If you
  417.                        get a dialog box entitled "Attribute Re-Order", you
  418.                        can safely assume that the installation has been a
  419.                        success.  Press <Cancel> to exit the dialog boxes,
  420.                        until you're back at the  Command:  prompt.
  421.  
  422.  
  423.             Once DrafTools is installed properly, you should read the
  424.        following sections before trying to use the DrafTools applications.
  425.  
  426.  
  427. ==============   DrafTools(tm) Installation & Operation Manual             10
  428.  
  429.  
  430.                       V. GETTING STARTED
  431.  
  432.  
  433.  
  434.             A. Using the Sample Title Blocks
  435.  
  436.  
  437.             The easiest way to understand how a custom title block works is
  438.        to examine the sample title blocks included on the installation
  439.        diskette (C_ARCH.BDR & D_ARCH.BDR).  When DrafTools looks for a title
  440.        block to insert, it looks for a file with the .BDR (for "BorDeR")
  441.        extension.  A .BDR file is simply an AutoCAD drawing whose file
  442.        extension has been changed from .DWG to .BDR, thereby denoting it as a
  443.        DrafTools title block.  The two sample title blocks (C_ARCH.BDR &
  444.        D_ARCH.BDR) cannot be loaded into AutoCAD directly because they have
  445.        the wrong extension; however by copying the .BDR files to .DWG files
  446.        (Ex. COPY C_ARCH.BDR C_ARCH.DWG), you can load these files into the
  447.        drawing editor like any other AutoCAD drawing.  To see what the border
  448.        file is made of, do that now for C_ARCH.BDR (the C-Size border).
  449.             Load the converted drawing C_ARCH.DWG into the drawing editor.
  450.        Change your units to 'Architectural' with the UNITS command.  Notice
  451.        that the lower left corner of the title block border is at the origin
  452.        (0,0,0).  This corner will become the title block's insertion point.
  453.        Zoom into the title block area of the drawing, so you can see the
  454.        attributes that have been defined in the title block.  You may notice
  455.        that the attributes are more representative of a Civil Engineering
  456.        drawing;  however, they will nevertheless demonstate the potential of
  457.        "smart" title blocks.
  458.             Select 'Define New Title Block Border' in the DrafTools pop-up
  459.        menu, then push <Re-order and Edit Attributes>.  You should be greeted
  460.        with a dialog box entitled 'Attribute Re-order'.  This is the main
  461.        "Attribute Editing" dialog.
  462.             Pick the <Get All> button in the top left section of the box.
  463.        This places all "ATTDEF" entities in the 'Attributes' List Box, listed
  464.        by their "tag".  Immediately after an addition to this list, all added
  465.        attributes are "selected" (highlighted):  un-select them by pressing
  466.        the <Deselect All> button beneath the list box.  Once no attributes
  467.        are selected ("Selected Items:  None" above the list box), click on
  468.        the "DRAWING" attribute to highlight it.  If this is the only
  469.        highlighted attribute ("Selected Items:  1" above the list box), then
  470.        the <Edit> button should become un-greyed.  Pick the <Edit> button to
  471.        edit the selected attribute definition.
  472.             You should be presented with the 'Edit Attribute Definition'
  473.        dialog box.  There are three items of interest:  The Tag ("DRAWING"),
  474.        the Prompt ("Drawing Name"), and the Default ("=(getdwgname)").  The
  475.        default value is an AutoLISP function in this case.  The function
  476.        (getdwgname) is defined in the sample TBLOCK.LSP file, and it returns
  477.        the current drawing file name;  e.g., when this title block is
  478.        inserted the default value for this attribute will be the name of the
  479.        drawing.  The process will be better understood by actually inserting
  480.        this title block.  Experiment with the features in the dialog boxes to
  481.        get a feel of their functionality before continuing.
  482.  
  483.  
  484. ==============   DrafTools(tm) Installation & Operation Manual             11
  485.  
  486.  
  487.  
  488.             Start a new drawing named "TEST", change to Architectural units,
  489.        then select 'Insert Title Block & Border' from the DrafTools pop-up
  490.        menu.  Select border 'C_ARCH' from the available list.  Next, define a
  491.        new drawing scale definition for title blocks:  Pick the <Add New...>
  492.        button in the 'Drawing Scale' section.  For 'Scale ID' enter the text
  493.        [1" = 8'], then enter a scale of [1"]=[8'] and press <OK>.  You have
  494.        just added [1" = 8'] to the list of available pre-defined scales.  You
  495.        will want to add others to this list as you find you need them.
  496.             Next, pick an insertion point for the title block.  Press <Pick
  497.        Point> and pick a point in the drawing area.  You can press <Check It
  498.        Out> at any time after you have specified a border name to see what
  499.        the title block will look like once it's inserted:  do that now.
  500.             If you are satisfied, press <OK> to insert the selected border.
  501.        You will be delivered to the standard AutoCAD attribute edit dialog to
  502.        enter attributes in the title block.  If all went according to plan
  503.        the default value of the Drawing Name attribute should be "TEST", the
  504.        name of the current drawing.
  505.             Push the <Next> button to advance to the next page, and enter
  506.        "Sword Excavating" (with all lower-case except first letters of the
  507.        words) for the INSTALLER attribute.  You will notice the default
  508.        values for the Installer's address and phone number are AutoLISP
  509.        functions beginning with two equal signs ('=='):  such a function
  510.        calculates the attribute value after you pick the <OK> button.  In
  511.        this case it will search a database of installer's names and addresses
  512.        (SSINST.DBF) for the correct values based on the entered value of the
  513.        'INSTALLER' attribute.  Pick the <OK> button to insert the title block
  514.        and border into the drawing.
  515.             Once a title block is inserted, you can edit its attributes by
  516.        selecting 'Edit Title Block Attributes' from the DrafTools pop-up
  517.        menu:  do this now.  As you can see, the installer's name and address
  518.        are "looked up" again after you edit attributes.
  519.             Once you have a title block on screen, select 'Insert Title Block
  520.        & Border' from the DrafTools pop-up menu again.  This time toggle the
  521.        'Replace Existing Title Block' button to "on" (checked).  Now insert
  522.        the "D_ARCH" border over top of the "C_ARCH" border (or insert the
  523.        "C_ARCH" border at a different scale).  The program looks in the
  524.        existing title block for tags of the same name as those in the
  525.        replacement, and copies their values to the new title block.  If more
  526.        than one title block exists in the drawing you will be prompted to
  527.        pick the insertion point of the one you want to replace.
  528.             After inserting a title block the global variable *DWGSCALE is
  529.        set to the scale of the title block just inserted.  To verify this,
  530.        type  !*DWGSCALE  at the Command: prompt.  This global variable can be
  531.        used by user functions in "smart" attributes if they need to know the
  532.        scale factor used by the title block.
  533.             Before exiting, the title block insertion program calls the
  534.        (SETSCALES) function (in TBLOCK.LSP) to set any pertinent system or
  535.        dimensioning variables to the selected scale.  Try inserting the
  536.        "C_ARCH" border at different scales and checking the DIMSCALE system
  537.        variable before and after the insertion.  (For more information, see
  538.        Appendix C, Supplied User Functions.)
  539.  
  540.  
  541. ==============   DrafTools(tm) Installation & Operation Manual             12
  542.  
  543.  
  544.             B. Defining Your Own Title Block
  545.  
  546.  
  547.             If you already use a conventional AutoCAD block as a title block,
  548.        disregard the following instructions to begin a new drawing and
  549.        instead load in your existing title block for editing.  You may need
  550.        to erase your border and edit your attributes to take advantage of
  551.        DrafTools' features.  If you use different borders for different paper
  552.        sizes, it is recommended that you save the attribute part of the title
  553.        block (that part which is the same in all title blocks) separately,
  554.        then use it as a starting point for drawing each size of border.
  555.             To define a new custom title block, start a new drawing and
  556.        create the title block and attributes with no border.  Make sure you
  557.        are drawing on layer zero (0), so that the inserted title block will
  558.        take on the characteristics of the layer on which it is inserted.  If
  559.        you are editing an existing block, make sure all entities are on layer
  560.        zero (0).  If you want some entities to have different linetypes or
  561.        colors, then change that property explicitly instead of putting the
  562.        entity on a layer with the desired characteristics.  This will prevent
  563.        problems in the future, as all entities in the title block will then
  564.        reside on the same layer.
  565.             First, draw all constant text and graphics entities such as
  566.        dividing lines, company logos, etc. which stay the same in every
  567.        drawing.  Next, define text attributes:  Select 'Re-Order Title Block
  568.        Attribs' from the 'DrafTools' pop-up menu.  Pick <New> to define a new
  569.        attribute.  (If you already have attributes defined, pick <Get All> to
  570.        load them into the attribute list box, then, after picking <Deselect
  571.        All>, select an attribute (shown by it's "tag") and pick <Edit> to
  572.        make any desired changes.)  Following are some pointers to keep in
  573.        mind when defining attributes:
  574.             1)  Give each attribute a unique tag name, so that it can be
  575.                        referenced later without confusion.
  576.             2)  Use the proper alignment method so that the resulting text
  577.                        will be properly aligned when inserted.
  578.             3)  Specify a concise prompt that will identify the attribute
  579.                        when you are editing attribute values during
  580.                        insertion.
  581.             4)  Use a different text style for attributes and non-attribute
  582.                        text.  A mono-spaced font works best for attributes
  583.                        because it allows you to determine a constant maximum
  584.                        string length for each individual attribute based on
  585.                        available space, whereas proportional spaced fonts
  586.                        vary in length depending on the actual characters in
  587.                        the string.
  588.  
  589.  
  590. ==============   DrafTools(tm) Installation & Operation Manual             13
  591.  
  592.  
  593.             5)  In order to let DrafTools do as much of your work as
  594.                        possible, specify a default value for each attribute.
  595.                        If the attribute value will usually be the same, use
  596.                        that value as a default.  You can also specify a
  597.                        "dynamic default value" by using either of the
  598.                        following methods:
  599.  
  600.                            a. precede an AutoLISP function with an equal sign
  601.                        (=).  The default will be the string returned by the
  602.                        function at the time of insertion.  This is useful,
  603.                        for instance, when prompting for the drawing date:
  604.                        the default value can be the current system date.
  605.                        Ex. '=(menucmd "M=$(edtime,$(getvar,date),M/D/YY)")'
  606.                        will return the current date as the default value.
  607.  
  608.                            b. precede an AutoLISP function with two equal
  609.                        signs (==).  This type of dynamic default value works
  610.                        in a similar fashion as the one just mentioned,
  611.                        except that the function does not evaluate until the
  612.                        attributes have all been entered and the block is
  613.                        being inserted.  This is useful if the value of one
  614.                        attribute depends on what was entered in another.
  615.                        One example would be when an address and phone number
  616.                        need to be looked up.  The user would first enter a
  617.                        name to use in the lookup, so the address and phone
  618.                        number cannot be retrieved until the user clicks <OK>
  619.                        to signify that the name has been entered.  A
  620.                        complete description of the LOOKUP function included
  621.                        in the TBLOCK.LSP file can be found in Appendix C,
  622.                        User Functions Supplied with DrafTools.
  623.  
  624.             Once you have what you like, save this drawing under a name like
  625.        'TITLE', so you can use it in the borders of different drawing sizes.
  626.        HINT:  If you re-order the attribute definitions before you SAVE (push
  627.        <Re-order and Edit Attributes> in the 'Define New Title Block Border'
  628.        dialog box and reorder them, then exit the dialog without creating a
  629.        border file), your attributes will appear in the correct order, and
  630.        won't need any re-ordering later.
  631.  
  632.  
  633. ==============   DrafTools(tm) Installation & Operation Manual             14
  634.  
  635.  
  636.             The next step is creating a .BDR file for different drawing
  637.        sizes.  Start a new drawing and give it an identifying name like "C"
  638.        or "C_GM" for the C-Size border.  Make sure you are drawing on Layer
  639.        zero (0).
  640.             Starting at the UCS origin (0,0,0), draw the border for the
  641.        selected drawing size, so that 0,0,0 is the lower-left corner of the
  642.        border.  Make sure that you draw the border at a scale of 1:1, so that
  643.        one drawing unit is equal to 1 plotted unit.  For example, if your
  644.        plotter's maximum plotting size for a C-Size sheet is 32.0" x 20.0"
  645.        and your drawing dimensions are in inches then your border should be
  646.        32.0 drawing units by 20.0 drawing units in size.
  647.             Once you have your border, insert the drawing of your title block
  648.        attributes at its proper position in the border.  Check the attribute
  649.        prompts and default values to make sure they are satisfactory, but
  650.        don't bother entering any attribute values.  Explode the attribute
  651.        block once it is positioned where you want it.  When the block is
  652.        exploded, the attributes it contained will display as attribute tags
  653.        and attribute values will be lost.
  654.             Now select 'Define New Title Block Border' from the 'DrafTools'
  655.        pop-up menu, and push <Re-order and Edit Attributes>.  This gives you
  656.        an opportunity to check the order of the attributes and to make any
  657.        modifications for this particular border size.  Once you are
  658.        satisfied, exit the 'Attribute Re-order' dialog by pushing either
  659.        <Reorder> or <Cancel>.  Push <Create New Border> in the main dialog
  660.        and enter the new border's filename when asked.  You now have a new
  661.        border available when you try to insert a new title block!  Try
  662.        inserting the new border, and see if it works.
  663.  
  664.  
  665. ==============   DrafTools(tm) Installation & Operation Manual             15
  666.  
  667.  
  668.             C. Customizing TBLOCK.LSP
  669.  
  670.  
  671.             The file TBLOCK.LSP is a SAMPLE file which contains a number of
  672.        functions used by the sample title blocks C_ARCH.BDR & D_ARCH.BDR.  It
  673.        also contains the (SETSCALES) function, which is evaluated each time a
  674.        new title block is inserted.
  675.             The sample TBLOCK.LSP file should be customized to fit your
  676.        needs:  delete any functions you don't need, and edit the (SETSCALES)
  677.        function to change variables such as DIMSCALE, TEXTSIZE, etc. to your
  678.        desired value, based on the entered drawing scale which is passed to
  679.        the function by the title block program.
  680.             NOTE:  the 'scale' argument passed to (SETSCALES) is the inverse
  681.        of the specified drawing scale.  This allows you to use 'scale' as a
  682.        multiplier when setting variables (that is, 'scale' can be multiplied
  683.        by a constant to return the appropriate value).
  684.  
  685.               Ex.:
  686.                       If 'Scale Factor' was 1" = 8'
  687.                         then 'scale' will be 96 (8'/1" = 96")
  688.  
  689.                       If 'Scale Factor' was 1 = 2
  690.                         then 'scale' will be 2 (2/1 = 2)
  691.  
  692.  
  693. ==============   DrafTools(tm) Installation & Operation Manual             16
  694.  
  695.  
  696.                       VI. REPORTING PROBLEMS & GETTING SUPPORT
  697.  
  698.  
  699.  
  700.  
  701.             Any problems with this software can be reported to the author via
  702.        CompuServe:
  703.                  Owen Wengerd
  704.                  71324,3252
  705.  
  706.        or via mail:
  707.                  DrafTools
  708.                  Manu-Soft Computer Services
  709.                  P.O. Box 84
  710.                  Fredericksburg, OH  44627
  711.  
  712.        or via phone:
  713.                  (216) 695-5903
  714.             (Call eves or leave name, phone number, & time to return call)
  715.  
  716.  
  717.             It is the author's desire to make this software as easy to use as
  718.        possible.  However, to make use of it's advanced features requires
  719.        some AutoLISP experience.  If you need help in that area it is
  720.        recommended that you find someone in your area who can get you started
  721.        in AutoLISP programming:  the benefits of learning to program in
  722.        AutoLISP will be well worth the effort.
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                                   VII. REGISTRATION
  729.  
  730.  
  731.  
  732.             You are encouraged to pass a copy of DrafTools(tm) along to your
  733.        friends for evaluation.  Please encourage them to register their copy
  734.        if they find that they can use it.  All registered users will receive
  735.        the following:
  736.                  The latest version of DrafTools(tm)
  737.                  Unprotected source code
  738.                  Free minor updates as they occur
  739.                  Free technical support
  740.                  Special reduced rates on major upgrades
  741.  
  742.  
  743.        To register, print the order form (!ORDER.FRM) and send it with check
  744.        or money order for $25.00 (US) per copy to:
  745.  
  746.             DrafTools
  747.             Manu-Soft Computer Services
  748.             P.O. Box 84
  749.             Fredericksburg, OH  44627
  750.  
  751.  
  752. ==============   DrafTools(tm) Installation & Operation Manual             17
  753.  
  754.  
  755.                       VIII. APPENDIX A--Files Included with DrafTools
  756.  
  757.  
  758.  
  759.             A. Installation and Documentation
  760.  
  761.  
  762.        README  .DOC   Start-up instructions & last minute details.
  763.  
  764.        !LICENSE.DOC   Licence, registration, and ordering instructions.
  765.  
  766.        !ORDER  .DOC   Order form.
  767.  
  768.        !PACKING.LST   List of included files.
  769.  
  770.        !MANUAL .TXT   This users manual.  Plain text format for on-line
  771.                        viewing.
  772.  
  773.        !MANUAL .PRN   This users manual.  COPY this file to any printer for a
  774.                        printed manual.
  775.  
  776.        ACADPMNU.TXT   This ASCII file defines the pop-up DrafTools menu, and
  777.                        must be inserted into your ACAD.MNU file.
  778.  
  779.  
  780.  
  781.             B. DrafTools Program Files
  782.  
  783.  
  784.        DT_INIT .LSP   This file defines custom settings and initializes
  785.                        DrafTools.  It must be loaded by your ACAD.LSP file.
  786.  
  787.        MAKEBDR .LSP   AutoLISP program that creates a new Title Block Border.
  788.  
  789.        MAKEBDR .DCL   Dialog box definition (DCL) file used by MAKEBDR.LSP.
  790.  
  791.        INSTITLE.LSP   AutoLISP program that inserts a new title block into a
  792.                        drawing.
  793.  
  794.        INSTITLE.DCL   Dialog box definition (DCL) file used by INSTITLE.LSP.
  795.  
  796.        INSTITLE.HLP   On-line help text for INSTITLE.LSP (AutoCAD help file
  797.                        format).
  798.  
  799.        EDTITLE .LSP   AutoLISP program that allows attribute value editing of
  800.                        a previously inserted title block.
  801.  
  802.        EDATTRIB.LSP   AutoLISP program for editing attribute definitions.
  803.  
  804.        EDATTRIB.DCL   Dialog box definition (DCL) file used by EDATTRIB.LSP.
  805.  
  806.        EDATTRIB.HLP   On-line help text for EDATTRIB.LSP (AutoCAD help file
  807.                        format).
  808.  
  809.        RE-ORDER.LSP   AutoLISP program for re-ordering and editing attribute
  810.                        definitions.
  811.  
  812.  
  813. ==============   DrafTools(tm) Installation & Operation Manual             18
  814.  
  815.  
  816.  
  817.        RE-ORDER.DCL   Dialog box definition (DCL) file used by RE-ORDER.LSP.
  818.  
  819.        RE-ORDER.HLP   On-line help text for RE-ORDER.LSP (AutoCAD help file
  820.                        format).
  821.  
  822.        XDOS_DT .C     Source code for XDOS_DT.EXP (ADS application).
  823.  
  824.        XDOS_DT .EXP   ADS application used by DrafTools for performing DOS
  825.                        file functions from within AutoCAD.  This routine was
  826.                        adapted from AutoDesk's XDOS utility.
  827.  
  828.  
  829.  
  830.  
  831.             C. Sample Programs
  832.  
  833.  
  834.        TBLOCK  .DWG   Sample title block design.
  835.  
  836.        C_ARCH  .BDR   Sample C-Size Title Block using TBLOCK.DWG.
  837.  
  838.        D_ARCH  .BDR   Sample D-Size Title Block using TBLOCK.DWG.
  839.  
  840.        TBLOCK  .LSP   AutoLISP functions required by TBLOCK.DWG.*
  841.  
  842.        SSINST  .DBF   DBase file containing names and addresses of septic
  843.                        system installers--used by sample title blocks.
  844.  
  845.        SSINST  .ASC   ASCII file of contents of SSINST.DBF, included only to
  846.                        show contents of DBase file.
  847.  
  848.  
  849.             *  DrafTools programs look for and load a file named TBLOCK.LSP
  850.                        before inserting or editing a title block.  This file
  851.                        contains the (SETSCALES) function (see Appendix C,
  852.                        Supplied User Functions) as well as any functions
  853.                        required by "dynamic default values".  However, if a
  854.                        function is only required by one particular title
  855.                        block it can be defined in xxxxxxxx.LSP where
  856.                        xxxxxxxx is the name of the title block xxxxxxxx.BDR
  857.                        file that uses it.  (That is, if you insert C.BDR,
  858.                        the file C.LSP will be loaded if it exists.)
  859.  
  860.  
  861. ==============   DrafTools(tm) Installation & Operation Manual             19
  862.  
  863.  
  864.                       IX. APPENDIX B--Global Variables
  865.  
  866.  
  867.  
  868.  
  869.        *DT_PATH  . . . . Pathname of DrafTools subdirectory.
  870.                        Ex.  "C:\\ACAD\\DRAFTOOL\\"
  871.  
  872.        *DWGSCALE . . . . Current Default Drawing Scale, set by specifying a
  873.                        drawing scale during title block insertion.
  874.  
  875.        *TBLAYER  . . . . String variable specifying name of layer for Title
  876.                        Blocks.  Default layer is "TITLE" if none specified.
  877.  
  878.        *TBSCALES . . . . String variable specifying name of file to use for
  879.                        storing predefined drawing scales.  Default filename
  880.                        is "TBSCALES.TBD" if none specified.
  881.  
  882.  
  883.        Note:  All Global variables that need to be set should be set in the
  884.                        DT_INIT.LSP file with the following AutoLISP command:
  885.                        (setq VARIABLE VALUE) where VARIABLE is the variable
  886.                        name and VALUE is its desired value.  String values
  887.                        must be specified in double quotes ("").
  888.  
  889.  
  890. ==============   DrafTools(tm) Installation & Operation Manual             20
  891.  
  892.  
  893.                       X. APPENDIX C--Supplied User Functions
  894.  
  895.  
  896.  
  897.        * All User functions are supplied AS SAMPLES ONLY, and reside in
  898.                        TBLOCK.LSP (see above)
  899.  
  900.  
  901.        (SETSCALES scale)--This function is used to set system and dimension
  902.                        variables after a drawing scale has been determined.
  903.                        It is automatically called by DrafTools when
  904.                        inserting a new title block.  This function may be
  905.                        edited to set variables as desired.
  906.  
  907.        (getdwgname)--Returns the name of the current drawing or the empty
  908.                        string ("") if the drawing is unnamed.
  909.  
  910.        (getattribval ent tag)--Returns a string, the 'value' of an attribute,
  911.                        where "ent" is the entity name of the block
  912.                        containing the attribute and "tag" is the attribute
  913.                        tag.
  914.  
  915.        (pack string)--Returns string "string" with trailing spaces removed.
  916.  
  917.        (lookup dbase tag index field)--Returns the contents of field "field"
  918.                        from a dbase .dbf file (database) in the record where
  919.                        the contents of the "index" field are equal to the
  920.                        current value of the attribute "tag".  This function
  921.                        is used to look up an address, for example, when
  922.                        another attribute contains the name of the person for
  923.                        whom you want an address.
  924.                        Example:  (lookup "SSINST.DBF" "INSTALLER" "NAME"
  925.                        "PHONE")
  926.  
  927.